home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_200 / 276_01 / a16.doc < prev    next >
Text File  |  1989-10-01  |  44KB  |  1,158 lines
  1. /*
  2.     HEADER:        CUG276;
  3.     TITLE:        PIC1650 Cross-Assembler (Portable);
  4.     FILENAME:    A16.DOC;
  5.     VERSION:    0.0;
  6.     DATE:        07/06/1989;
  7.     SEE-ALSO:    A16.H;
  8.     AUTHORS:    William C. Colley, III;
  9. */
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                          PIC1650 Cross-Assembler (Portable)
  25.  
  26.  
  27.                                      Version 0.0
  28.  
  29.  
  30.                  Copyright (c) 1985,1987,1989 William C. Colley, III
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                               The manual such as it is.
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.           Legal Note:    This package may be used for any commercial or
  50.                          non-commercial purpose.  It may be copied and
  51.                          distributed freely provided that any fee charged
  52.                          by the distributor of the copy does not exceed the
  53.                          sum of:  1) the cost of the media the copy is
  54.                          written on,  2) any required costs of shipping the
  55.                          copy, and  3) a nominal handling fee.  Any other
  56.                          distribution requires the written permission of
  57.                          the author.  Also, the author's copyright notices
  58.                          shall not be removed from the program source, the
  59.                          program object, or the program documentation.
  60.  
  61.  
  62.  
  63.                                   Table of Contents
  64.  
  65.           1.0  How to Use the Cross-Assembler Package ..................  3
  66.           2.0  Format of Cross-Assembler Source Lines ..................  4
  67.                2.1  Labels .............................................  5
  68.                2.2  Numeric Constants ..................................  5
  69.                2.3  String Constants ...................................  6
  70.                2.4  Expressions ........................................  6
  71.           3.0  Machine Opcodes .........................................  7
  72.                3.1  Opcodes -- No Arguments ............................  7
  73.                3.2  Opcodes -- Immediate Operations ....................  7
  74.                3.3  Opcodes -- Register Operations .....................  8
  75.                3.4  Opcodes -- Register-to-Accumulator Operations ......  8
  76.                3.5  Opcodes -- Register Bit Operations .................  8
  77.                3.6  Opcodes -- Branch Operations .......................  8
  78.                3.7  Opcodes -- Built-In Macros .........................  8
  79.           4.0  Pseudo Opcodes .......................................... 10
  80.                4.1  Pseudo-ops -- DS ................................... 10
  81.                4.2  Pseudo-ops -- DW ................................... 10
  82.                4.3  Pseudo-ops -- END .................................. 10
  83.                4.4  Pseudo-ops -- EQU .................................. 11
  84.                4.5  Pseudo-ops -- IF, ELSE, ENDIF ...................... 11
  85.                4.6  Pseudo-ops -- INCL ................................. 12
  86.                4.7  Pseudo-ops -- ORG .................................. 12
  87.                4.8  Pseudo-ops -- PAGE ................................. 12
  88.                4.9  Pseudo-ops -- SET .................................. 13
  89.                4.10 Pseudo-ops -- TITLE ................................ 13
  90.           5.0  Assembly Errors ......................................... 13
  91.                5.1  Error * -- Missing Statement ....................... 13
  92.                5.2  Error ( -- Parenthesis Imbalance ................... 14
  93.                5.3  Error " -- Missing Quotation Mark .................. 14
  94.                5.4  Error A -- Address Out of Bounds ................... 14
  95.                5.5  Error B -- Illegal Bit Number ...................... 14
  96.                5.6  Error D -- Illegal Digit ........................... 14
  97.                5.7  Error E -- Illegal Expression ...................... 14
  98.                5.8  Error I -- IF-ENDIF Imbalance ...................... 15
  99.                5.9  Error L -- Illegal Label ........................... 15
  100.                5.10 Error M -- Multiply Defined Label .................. 15
  101.                5.11 Error O -- Illegal Opcode .......................... 15
  102.                5.12 Error P -- Phasing Error ........................... 15
  103.                5.13 Error R -- Illegal Register Number ................. 16
  104.                5.14 Error S -- Illegal Syntax .......................... 16
  105.                5.15 Error T -- Too Many Arguments ...................... 16
  106.                5.16 Error U -- Undefined Label ......................... 16
  107.                5.17 Error V -- Illegal Value ........................... 16
  108.                5.18 Error W -- Illegal Direction Designator ............ 16
  109.           6.0  Warning Messages ........................................ 16
  110.                6.1  Warning -- Illegal Option Ignored .................. 17
  111.                6.2  Warning -- -l Option Ignored -- No File Name ....... 17
  112.                6.3  Warning -- -o Option Ignored -- No File Name ....... 17
  113.                6.4  Warning -- Extra Source File Ignored ............... 17
  114.                6.5  Warning -- Extra Listing File Ignored .............. 17
  115.                6.6  Warning -- Extra Object File Ignored ............... 17
  116.  
  117.  
  118.  
  119.  
  120.                                      1
  121.  
  122.  
  123.  
  124.           7.0  Fatal Error Messages .................................... 17
  125.                7.1  Fatal Error -- No Source File Specified ............ 17
  126.                7.2  Fatal Error -- Source File Did Not Open ............ 18
  127.                7.3  Fatal Error -- Listing File Did Not Open ........... 18
  128.                7.4  Fatal Error -- Object File Did Not Open ............ 18
  129.                7.5  Fatal Error -- Error Reading Source File ........... 18
  130.                7.6  Fatal Error -- Disk or Directory Full .............. 18
  131.                7.7  Fatal Error -- File Stack Overflow ................. 18
  132.                7.8  Fatal Error -- If Stack Overflow ................... 18
  133.                7.9  Fatal Error -- Too Many Symbols .................... 18
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.                                      2
  182.  
  183.  
  184.  
  185.           1.0  How to Use the Cross-Assembler Package
  186.  
  187.                First, the question, "What does a cross-assembler do?" needs
  188.           to be addressed as there is considerable confusion on this point.
  189.           A cross-assembler is just like any other assembler except that it
  190.           runs on some CPU other than the one for which it assembles code.
  191.           For example, this package assembles PIC1650 source code into
  192.           PIC1650 object code, but it runs on an 8088, a 68000, or whatever
  193.           other CPU you happen to have a C compiler for.  The reason that
  194.           cross-assemblers are useful is that you probably already have a
  195.           CPU with memory, disk drives, a text editor, an operating system,
  196.           and all sorts of hard-to-build or expensive facilities on hand.
  197.           A cross-assembler allows you to use these facilites to develop
  198.           code for an PIC1650.
  199.  
  200.                This program requires one input file (your PIC1650 source
  201.           code) and zero to two output files (the listing and the object).
  202.           The input file MUST be specified, or the assembler will bomb on a
  203.           fatal error.  The listing and object files are optional.  If no
  204.           listing file is specified, no listing is generated, and if no
  205.           object file is specified, no object is generated.  If the object
  206.           file is specified, the object is written to this file in "Intel
  207.           hexadecimal" format.
  208.  
  209.                The command line for the cross-assembler looks like this:
  210.  
  211.                     A16 source_file { >list_file } { -o object_file }
  212.  
  213.           where the { } indicates that the specified item is optional.
  214.  
  215.                Some examples are in order:
  216.  
  217.                a16 test16.asm                          source:   test16.asm
  218.                                                        listing:  none
  219.